home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 016a / dta17.zip / DTA.DOC < prev   
Text File  |  1992-01-08  |  15KB  |  291 lines
  1.  
  2.                                    DTA.DOC
  3.                                    -------
  4.                            Instructions for DTA.COM
  5.                            Version 1.7 (08 Jan 1992)
  6.  
  7.                              (c)1987-92 E. Meyer
  8.  
  9.  
  10.      DTA.COM is a super directory utility that will run on any PC/MSDOS system 
  11. (version 2 or higher).  "DTA" stands for Directory-Tree-Attributes; it is a 
  12. replacement for the DIR, TREE, and ATTRIB commands of DOS, as well as a 
  13. WHEREIS utility.  Though small, DTA has many features including:
  14.  
  15.     *  alphabetized color directory with file sizes and free space
  16.     *  optional wide mode or full mode (with attributes and time/date)
  17.     *  select items to display by attributes, time/date, or file size
  18.     *  display several groups of files, or all except certain files
  19.     *  change any file attributes or time/date
  20.     *  treat directories either separately or together with files
  21.     *  alphabetized compact directory tree; optional full mode with sizes
  22.     *  optionally search entire drive (all directories) for files
  23.  
  24.      The syntax and options of DTA are compatible with my ARCOPY (archive/ 
  25. copy), DIRCMP (directory compare), and DLT (delete) file utilities, which work 
  26. well together.
  27.  
  28.  
  29.                                   USING DTA
  30.                                   ---------
  31.  
  32. SYNTAX:    A>dta {fspec1} {{,}fspec2...} {/options}           ("{}"=optional)
  33.  
  34.         where  each "fspec" may include a drive, path, or wildcards;
  35.                either spaces or commas may separate multiple filespecs;
  36.                "/" is the delimiter for option letters.
  37.  
  38.      If the drive or path is omitted from the first filespec, it defaults to 
  39. the current DOS value; for subsequent ones, to the same as the previous one.  
  40. If the filespec is omitted it defaults to "*.*".  If it is a directory name, 
  41. the contents of the directory are displayed.
  42.      Options are discussed in detail below.  If none are specified, you will 
  43. get a compact, informative directory display.
  44.  
  45.      You can pause or abort during operation of DTA by typing ^S or ^C.  
  46. Output can be directed to a file or other device in the standard fashion:
  47.                 A>DTA FILESPEC /OPTIONS >DEVICE.
  48. (Note: if you are using color output, you must disable it with the /M option 
  49. or redirection will not work.)
  50.  
  51.  
  52.                            INTERPRETING THE DISPLAY
  53.                            ------------------------
  54.  
  55.      SIZES are measured in kilobytes (1k is 1024 bytes) or megabytes (1m is 
  56. 1024k, or 1,048,576 bytes).  DTA displays them in kilobytes up to 999k; beyond 
  57. that, to the nearest tenth of a megabyte (1.0m, etc).  The "items total" 
  58. amount is simply the sum of the individual file sizes shown; the "items use" 
  59. amount is the total disk space those files actually occupy.  (If any 
  60. directories are shown, the sizes of their contents are not included.)  Because 
  61. allocation clusters on a disk can vary from 128 bytes (on a RAMdisk) to 4k (on 
  62. a hard disk), the space consumed by each file can be a fraction of a k less or 
  63. several k more than its displayed size; thus, depending on disk media, the 
  64. "use" amount may be a bit less, or significantly more, than the "total" of the 
  65. displayed sizes.  The "used/free" space shown by DTA is for the entire drive.
  66.  
  67.      ATTRIBUTES, when displayed, show as a letter ("A,H,R,S") if set, or as 
  68. "." if clear.  The Archive attribute indicates to a backup utility that a file 
  69. has been changed recently, and needs to be backed up; the bit is cleared by 
  70. the utility when it does so.  (Simple backup utilities that work well with DTA 
  71. include the DOS XCOPY command, and my own ARCOPY.COM.)
  72.      The Read-only attribute prevents a file from being changed or deleted, 
  73. though it can be read and copied.  The Hidden and System attributes both 
  74. exclude items from normal searches: they cannot be accessed at all by ordinary 
  75. MSDOS file commands.  Ordinarily only the DOS boot files MSDOS.SYS and IO.SYS 
  76. have these attributes.  (If you do NOT want to see hidden or system items, use 
  77. options "/hs".)
  78.  
  79.      TIME/DATE, when displayed, appear in the appropriate format for your DOS 
  80. country setting, unless you have set a different default with DEBUG, or a 
  81. different entry format (Euro,Num) was used with the /B,/L,/@ options.
  82.  
  83.  
  84.                                  DTA OPTIONS
  85.                                  -----------
  86.  
  87.      By default, DTA will display a list of all files specified, along with 
  88. their sizes, and some disk space information.  You can modify this consid- 
  89. erably with a variety of options.  One "/" must precede any options; further 
  90. slashes may be used or not, as desired.
  91.  
  92.      /? = help.  Gives version message, brief summary of usage and options.
  93.  
  94. There are options to scan the directory tree, instead of the current dir:
  95.      /T = tree: show it, starting at specified or current directory.
  96.      /G = global: search for specified files throughout the tree.
  97.  
  98. Then there are options affecting the appearance of the display:
  99.      /F = full: for directory, show attributes and time/date also.
  100.                   (automatically selected for single file display)
  101.                 for tree/global search, show file size information.
  102.      /W = wide: just like DIR /W, five columns with no file sizes.
  103.      /N = narrow: use only half the usual number of columns.
  104.      /M = mono: use monochrome output instead of color (or vice versa).
  105.      /P = pause: after every screenful, pause for a keystroke.
  106.  
  107. Then there are options to select what items are chosen for display:
  108.      /X = except: select only items other than those named.
  109.      /D = directories: select directories instead of files.
  110.      /U = universal: select both directories and files.
  111.      /B = before: select files before specified date,time.
  112.      /L = later: select files later than specified date,time.
  113.      /K = size: select files by specified size ("+"=greater, "-"=less).
  114.      /A,H,R,S = select only items with the specified attributes:
  115.                  Archive; Hidden; Read-only; System.
  116.      /a,h,r,s = select only items WITHOUT these attributes.
  117.  
  118. Finally, you can specify:
  119.      /@ = set time stamp on items to date,time.
  120.      /C = change items to have the following specified attributes.
  121.  
  122.      Be careful with the /@,/C options, because they actually CHANGE the DOS 
  123. time stamp and attributes for files!  Time stamps, especially, provide 
  124. valuable information about the age and revision of a file, and should not be 
  125. changed without good reason.
  126.  
  127.      With the /B,/L,/@ options, the date and/or time should follow the option 
  128. letter; if both are specified, separate them with a comma.  If the time is 
  129. omitted, it defaults to 0 hours (12am); if the date is omitted, it defaults 
  130. to TODAY.  If both are omitted, /@ defaults to today, now; /B,/L default to 
  131. today, 0 hours.  DTA recognizes U.S., European, and Numeric formats for 
  132. entering each, by the punctuation used:
  133.        U.S.(M/D/Y,H:MMa-p)    Euro (D.M.Y,H:MM)     Num (Y-M-D,HHMM)
  134.           3/25/90,1:45p    =    25.3.90,13:45    =    90-3-25,1345
  135. (If you add the /A or /P option after a Euro format time, insert a slash or 
  136. space so it doesn't look like a U.S. format time.)  The date "00/00/00" may be 
  137. used to set a blank or zero timestamp; otherwise the year must be 80 or above.
  138.      To make selecting files by age more convenient, you can specify a time so 
  139. many days or hours AGO simply by using a "-" sign: thus "-3" means 3 DAYS ago, 
  140. "-,2" means 2 HOURS ago.
  141.  
  142.      With the /K option, the file size in "k" (from 0 to 999) should follow 
  143. the option letter; files of that size only will be listed.  Add a "-" after 
  144. the size to include smaller files as well, or a "+" to include larger ones.
  145.  
  146.      Note that the file attribute options are case sensitive (uppercase=set, 
  147. lower=clear).  Those listed alone, or before the "C" option letter, are used 
  148. for file selection; those after it, represent changes to be made.  The /C 
  149. option can also be used alone, with NO following attributes, simply to cause 
  150. attributes to display instead of file sizes (no attributes will be changed).
  151.  
  152.      The options /T,G,X do not allow multiple arguments; and a number of 
  153. combinations of options are invalid (/U or /D with /K,E,L,G; /T,G,X with one 
  154. another; /G with /@,C; etc).
  155.  
  156.      The best way to make DTA usage clear will be by a series of examples.
  157.  
  158.  
  159.                        EXAMPLES: FILES and DIRECTORIES
  160. C>dta a:\*.doc *.txt
  161.   Show all files *.DOC and *.TXT in the root directory on A:.
  162. C>dta a:\*.sys /xf
  163.   Show all files EXCEPT *.SYS, with "full" display (attributes and time/date).
  164. C>dta \work /u
  165.   Show all files AND subdirectories in C:\WORK.
  166. C>dta /d
  167.   Show all subdirectories in the current directory.
  168.  
  169.                         EXAMPLES: SIZES and TIMESTAMPS
  170. C>dta d: e: /k0
  171.   Show only empty (0k) files in the current directory on drives D: and E:.
  172. C>dta \work /l-2
  173.   Show only files in directory C:\WORK dated in the past two days.
  174. C>dta /b9/1/89
  175.   Show only files in current directory dated before 9/1/89.
  176. C>dta *.doc /l/b1700
  177.   Show only files *.DOC dated today before 5:00pm.
  178. C>dta log /@1.9.89,13:20
  179.   Change the timestamp of file C:LOG to 9/1/89, 1:20pm.
  180. C>dta \mydir? /d@
  181.     Change the timestamp of directory C:\MYDIR to today, now.  (Note the "d" 
  182.   option and the "?" wildcard, to specify directories beginning with "MYDIR" 
  183.   in the root directory.  If you just use "dta \mydir", DTA looks at items IN 
  184.   \MYDIR, rather than the directory entry itself.)
  185.  
  186.                              EXAMPLES: ATTRIBUTES
  187. C>dta /cp
  188.   Show all files *.* with their attributes, pausing after each screenful.
  189. C>dta /A
  190.   Show only files in current directory marked with the Archive attribute.
  191. C>dta a: /SH
  192.   Show only files in current directory on A: which are System and Hidden.
  193. C>dta a:*.sys /Hca
  194.   Select only Hidden files *.SYS on A: and clear their Archive attribute.
  195.  
  196.                        EXAMPLES: TREE and GLOBAL SEARCH
  197. C>dta \work /tf
  198.   Show the directory tree starting from C:\WORK, including size information.
  199. C>dta /gl
  200.   Find all files on drive C: that have been modified today.
  201. C>dta *.bak /gk100+f
  202.   Find all files *.BAK of 100k or larger on drive C:, and show total sizes.
  203.  
  204.  
  205.                                CUSTOMIZING DTA
  206.                                ---------------
  207.  
  208.      You can use DEBUG or a similar utility to change DTA's default time/date 
  209. format, as well as text colors (on IBM PC compatibles).  Use of contrasting 
  210. colors can make the display more easily readable.  All values below are in 
  211. hexadecimal.
  212.  
  213.    ADDRESS    ORIGINAL
  214.  IN DTA.COM    VALUE     FUNCTION               POSSIBLE VALUES
  215.     0102         FF    Default format     FF=default, 00=US, 01=Euro, 02=Num
  216.     0103         01    IBM PC compatible  01=test, 00=NO, FF=YES
  217.     0104         07    Message color      00-FF \
  218.     0105         0F    Name color         00-FF  >see below
  219.     0106         07    Attribute color    00-FF /
  220.  
  221.      DEFAULT FORMAT:  With 0102 set to FF, DTA will use the current DOS 
  222. country code to determine its default time/date format.  If you need to 
  223. override this, you can specify another format.  In any case, if you enter any 
  224. time options (/B,L,@) DTA will adopt whatever format you use.
  225.  
  226.      COMPATIBILITY:  With 0103 set to 01, DTA can usually detect whether it's 
  227. running on an IBM PC compatible, in which case it will use color output and 
  228. the /P option will recognize the current screen size; otherwise it uses 
  229. standard DOS output and assumes a 25 line screen.  If DTA fails to recognize 
  230. your computer properly, or you simply don't want these features, you can 
  231. override the test by changing 0103 to 00 or FF, for No or Yes.  The color 
  232. setting can also be reversed with the /M option.
  233.  
  234.      COLORS:  Specify each color by a pair of hex digits for background and 
  235. foreground, according to the following codes:
  236.          0 = BLACK   4 = red       8 = GREY           C = bright red
  237.          1 = blue    5 = magenta   9 = bright blue    D = bright magenta
  238.          2 = green   6 = brown     A = bright green   E = yellow
  239.          3 = cyan    7 = WHITE     B = bright cyan    F = BRIGHT WHITE
  240. For example, "17" means "blue background, white text".
  241.      All monochrome screens can display black, white, and bright white; in 
  242. some cases, grey may also be visible.
  243.      Colors 8-F should generally be avoided as background colors because they 
  244. produce blinking video.  On EGA/VGA displays, if blinking video is disabled, 
  245. the whole range of background colors will be available.
  246.  
  247.      EXAMPLE:  To change to numeric time/date format as default, type "DEBUG 
  248. DTA.COM", then "E0102 02", then "W", then "Q".
  249.  
  250.      Please distribute copies of DTA with original settings only, to avoid 
  251. confusing other users.
  252.  
  253.  
  254.  
  255.                                 ERROR MESSAGES
  256.  
  257.      "<out of memory>" - Not enough free memory to run DTA, or over 1000 items 
  258. to list (try a more restrictive filespec).
  259.  
  260.      "<invalid argument>" - Invalid or conflicting option, bad path, illegal 
  261. character in filename, that sort of thing.  Think and try again.
  262.  
  263.      "0 items" - No such file (or directory) was found.  (If you expected 
  264. there to be some, check your arguments again...)
  265.  
  266.  
  267.                                    HISTORY
  268.  
  269.  DA 1.0 (Sep87) - First release, based on my previous CP/M utility DA.
  270.     1.1 (Aug88) - Improved parsing; select AND change attributes; new options.
  271. DTA 1.2 (Oct88) - Added /T tree option; DA is now called DTA.
  272.     1.3 (Sep89) - Added /G search, /E,L,@ options for time/date.
  273.     1.4 (Mar90) - Added /X (except) option; removed /V (version) option.
  274.     1.5 (May91) - US/Euro/Numeric date,time; /E changed to /B(efore).
  275.     1.6 (Sep91) - Multiple filespecs; added /K (size) option; file selection
  276.                     options work with /G; improved, color display.
  277.     1.7 (Jan92) - Added /M (mono) option; /B,L,@ accept "-" for "ago";
  278.                     handles drive sizes over 64meg; uses DOS country code.
  279.  
  280.  
  281.      DTA and its documentation are (c)1987-92 Eric Meyer, all rights reserved.  
  282. They may be freely distributed, but not modified or sold for profit without my 
  283. written consent.  (Exception: Libraries may charge up to $6 for a disk.)  The 
  284. user takes full responsibility for any damages resulting from the use of this 
  285. program.  For a disk with the latest versions of all my programs send $10 to:
  286.  
  287.                  Eric Meyer
  288.               3541 Smuggler Way              CompuServe [74415,1305]
  289.            Boulder, CO  80303  USA
  290.  
  291.